home *** CD-ROM | disk | FTP | other *** search
/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / LIBRARY / FUTILS / READ.ME < prev    next >
Text File  |  1989-02-24  |  7KB  |  149 lines
  1.                                RKCP 
  2.  
  3. ********************************************************************
  4. ***************************** READ.ME ******************************
  5. ********************************************************************
  6.  
  7.    Before you start looking at the documentation, I just want to
  8. outline the seven units in this archive.
  9.  
  10. FSWAP  A TP5 unit written in assembly language for very fast swapping
  11.        of variables with no "storage space" that is typical of Pascal
  12.        swapping procedures.  Three routines.  Ver. 0.3
  13. FSTACK A TP5 unit written in assembly language for array-based stacks.
  14.        Handles only byte and word sizes, but there is NO per item
  15.        overhead, and using getmem and freemem you can even arrange
  16.        it so there is no overhead anywhere at all!  Fourteen routines.
  17.        Ver. 0.4
  18. FBIOS  Another TP5 unit written in assembly language.  This one calls
  19.        various BIOS interrupts.  Interrupts are called much much faster
  20.        from assembly language than the INTR procedure supplied with
  21.        TP.  Only relativly "safe" routines have been included; I don't
  22.        want any disks ruined.  Sixteen routines.  Ver. 0.1
  23. FWRITE A fourth TP5 unit written in assembler.  This one has ultra-high
  24.        speed routines to read and write from the screen.  It is
  25.        supposed to cause snow on "snowy" CGA cards (I haven't tried it
  26.        out, however) and it doesn't autodetect EGA or VGA cards.  But
  27.        you can read characters, lines or whole screens, and write
  28.        likewise.  You can also redirect the output from the screen to
  29.        a predefined type (Vram_ScrBuf), or ANY buffer large enough (4000
  30.        bytes for a 80*25 screen).  Ninteen routines.  Ver. 0.7
  31. FWIN   A windowing program in TP5.  It uses FWRITE, so it has the same
  32.        snow and detection problems as FWRITE.  As well as the windowing
  33.        routines, there are also some general-purpose procedures and
  34.        functions, GetXY being an example.  FWIN can leave images or
  35.        parts of images on the screen after deleting windows, depending
  36.        on how the windows are called.  Ten routines.  Ver. 0.8
  37. XWIN   Another windowing program in TP5.  This is basically the same as
  38.        FWIN.  It doesn't have the leftover image problem that FWIN does,
  39.        and it uses less memory per window.  It is slower, but that
  40.        can't be helped.  Eleven routines.  Ver. 0.0
  41. FILE1  A TP5 unit for more advanced file routines with error checking.
  42.        Uses heap for typing and copying buffer.  Buffer adjusts from
  43.        1k to 32k depending on the amount of free heap available.
  44.        Five routines.  Ver. 1.0
  45.  
  46.    That's all of them.  I just want to warn of one thing:  do NOT use
  47. mark and release when you use either of the windowing programs!  You
  48. can release the window memory, which would be disasterous to both the
  49. windows and your program.  Also, check the free heap before you call
  50. CreateWindow in either windowing unit.  You need roughly 5k free for
  51. one FWIN window and a varying amount for XWIN (but never more than 5k).
  52. If you know you have plenty of space to spare, you don't need to check,
  53. but if you're getting close, it won't hurt and it could save a run-time
  54. error.
  55.  
  56.    Generally, none of the units check that the values passed are in a
  57. valid range.  (FILE1 is an exception.)
  58.  
  59.    These units are shareware, but we'll get to that in a moment.
  60.  
  61.     RKCP  stands for Rex Kerr's Compiliers and Programs.  Currently
  62. I only have programs (or programming aids like these).  I'm going to
  63. get started on compilier-writing real soon now.  Nothing as advanced
  64. as TP5, I don't think, but some useful compiliers and maybe even
  65. a parser generator for Turbo Pascal.
  66.  
  67.                           >>Shareware<<
  68.  
  69.    These units are shareware.  You can have as long as you think you
  70. need (within reason [reason is about 2 months {at the most}]) to try
  71. them out.  When and if you decide you like them and want to use them,
  72. you will be expected to register them.  There is one exception to this.
  73. If you are using *ONLY* FSWAP, you don't have to register.  I can't see
  74. why anyone would only want to use just it, but in case you do....  Also,
  75. if any of these units are going to be included in a COMMERCIAL product,
  76. that will cost you one (free) copy of that product.  Registration is
  77. $10, which includes all help I can give and the most recent versions
  78. of these seven units.  This is probably the final FWIN, but I'll see.
  79. Registration does NOT include a manual.
  80.  
  81.    I have not included any source code with the programs for two reasons.
  82.  
  83.    1)  None of the source code is commented yet.  If I did include it,
  84.        I doubt anyone would be able to understand it.
  85.    2)  When you register, I will send you all the of the source code
  86.        (commented).  This way, I can be sure that anyone who is
  87.        *REALLY* interested will register.
  88.  
  89.    By the way, if you think these units are worth more than $10, I
  90. certainly have no objections to you sending more.
  91.  
  92.    If you have any ideas about other units or additions to one or
  93. more of these units, or about any ideas for a new compilier or
  94. anything else, don't hesitate to contact me.  The best way is
  95. through EasyPlex on CompuServe.  If you think your questions or
  96. requests might be of general interest, you can post a message in
  97. the TP5 section of BPROGA's message section (this is also on
  98. CompuServe).  If you don't want to do it that way, I suppose you
  99. can always mail a letter to me.  My address is
  100.  
  101. 8301 Buckingham Drive
  102. El Cerrito, CA  94530
  103.  
  104. and my CompuServe ID number is
  105.  
  106. 71550,3147
  107.  
  108.    I will return any mail or messages the same way I got it unless
  109. you specify to do otherwise.
  110.  
  111.    I suggest proceeding in this order:
  112.  
  113.    1) Finish reading this.
  114.  
  115.    2) Run FTPUDEMO for a demonstration of the different programs.
  116.  
  117.    3) Un-arc FDOCS.ARC and read the documentation for the units.
  118.  
  119.    4) Un-arc FTPUS.ARC and start using the units.
  120.  
  121.    5) Do whatever.  If you need to review the docs or want to run
  122.       the demo again, go ahead.  You don't even really have to
  123.       follow this order to make sense out of things, but I think
  124.       it would help.
  125.  
  126.    The strange thing is, the units take up about 20k altogether.  But
  127. the documentation takes up 40k!  Gee....
  128.  
  129.    Actually, that's not as bad as it seems.  Recently I downloaded a
  130. fast writing file from CompuServe (to take a look at my competition)
  131. and the TPU file was only about 8k.  But the documentation was 150k.
  132. Wow!  I got pretty board while it was downloading.  So after downloading
  133. this 100k file (it was ARCed, of course) I decided that I wouldn't
  134. have the documentation more than three as large as the units.  I tried
  135. not to sacrifice any clarity by keeping the files short, and I hope I
  136. have succeded.
  137.  
  138.    Well, now that I have finished my least favorite part of programming
  139. (writing documentation) I can start again on my favorite part (coming
  140. up with good ideas and making them work).
  141.  
  142.  
  143.    I hope you find at least one of the units useful, and if you do I
  144. hope to hear from you.
  145.  
  146. <<< Rex Kerr >>>
  147.  
  148.                                RKCP 
  149.